home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / dev / misc / SDL-Amiga.readme < prev    next >
Text File  |  2002-10-26  |  5KB  |  130 lines
  1. Short:    Version 1.2.5 of Amiga SDL audio/video library
  2. Author:   Gabriele Greco
  3. Uploader: gabriele.greco@aruba.it
  4. Version:  1.2.5
  5. Type:     dev/misc
  6. Replaces: AmigaSDL.lha
  7.  
  8. This is the porting of 1.2.5 version of SDL (the latest stable one)
  9. to AmigaOS 68k and MorphOS.
  10.  
  11. OpenGL is temporary left out from this version since at the moment is quite 
  12. unusable and it will be so until we have a complete OpenGL hardware implementation
  13. on a NATIVE operative system (SDL Warpos + Warp3D is NOT enough to run modern OpenGL
  14. games without a lot of reworking).
  15.  
  16. All the bugs known of the past version have been corrected. And I've
  17. added all the new SDL features.
  18.  
  19. This version of SDL needs Cybergraphx V3 (r69+) or CyberGraphX V4
  20. and AHI v3+. It works also with P96, althrough there are still some color
  21. problems with certain bitperpixel values.
  22. Maybe it works also with CGXAga, but it's untested.
  23.  
  24. Implemented:
  25.  
  26. - 8/16/24/32bit video modes, both fullscreen and windowed.
  27. - CGX hardware surfaces (blitting acceleration, also in colorkey blitting)
  28. - AHI audio (8/16 bit, with any audio format), always uses unit 0 for now.
  29. - Thread & semaphores support through exec/execppc.
  30. - Window resizing and backdrop windows
  31. - Joystick/Joypad support.
  32. - OpenGL (through StormMESA and Warp3D) (not compiled in in this version)
  33.  
  34. To do:
  35.  
  36. - CDRom audio playing support
  37.  
  38. The SASC/GCC/Morphos libraries are distributed with debug enabled, to strip debug info 
  39. with SASC simply add STRIPDEBUG argument to the linker and define a FAKE kprintf, with gcc
  40. run "strip" on your binaries. 
  41. Otherwise if you want to see debug infos link with the included debug.lib/libdebug.a.
  42.  
  43. Installation:
  44.  
  45. 1) Shared library (every language/compiler, 68k)
  46.  
  47. - cd the main directory SDL
  48.  
  49. - copy libs/SDL.library libs:
  50.  
  51. - If your compiler is SAS:
  52.   copy include/clib/#? include:clib/
  53.   copy include/pragmas/#? include:pragmas/
  54.   copy include/SDL include:SDL all
  55.  
  56. - If your compiler is GCC:
  57.   copy include/inline/#? gg:include/inline 
  58.   copy include/SDL gg:include/SDL all
  59.   copy bin/sdl-config gg:bin
  60.  
  61. - Otherwise:
  62.   use the provided file fd/SDL.fd with include/clib/SDL_protos.h to produce a working
  63.   stub library/inline/pragma suited for your compiler/language, one program that does
  64.   this for various compilers is fd2pragma, available in Aminet.
  65.  
  66. 2) SAS/C:
  67. - copy lib/#?.lib sc:lib
  68. - add the directory where SDL includes are stored to your makefile with IDIR=dir or
  69.   copy includes to your include: assign (copy include/#? include:)
  70. - Add to your link directive in the makefile "LIB lib:sdl.lib lib:debug.lib" for 
  71.   nonGL apps and "LIB lib:sdlgl.lib lib:mesa.lib lib:debug.lib" for GL apps. 
  72. - You can get rid by debug.lib if you define an empty kprintf() in your code.
  73.  
  74.  
  75. 3) GCC/68k:
  76. - copy lib/#?.a gg:lib/
  77. - copy bin/sdl-config gg:bin
  78. - place the SDL includes in gg:os-include or in a custom directory and add it to your
  79.   include search path with -Idir.
  80. - link with -lSDL -ldebug -lpthread (-lSDLgl -lGL -ldebug -lpthread for gl apps). 
  81.   Pthread is required since ixemul libc is not multithread safe (you can omit it if
  82.   you are using a single thread).
  83. - you can both link it with or without ixemul, but libnix executables (-noixemul) has
  84.   better performances
  85.  
  86. 4) GCC/MorphOS:
  87. - copy lib_mos/#?.a gg:lib/
  88. - copy bin/sdl-config gg:bin
  89. - place the SDL includes in gg:os-include or in a custom directory and add it to your
  90.   include search path with -Idir.
  91. - link with -lSDL -ldebug (gl apps NOT supported).
  92. - debug kprintf are disabled by default unless you have ggdebug.library (on aminet) in
  93.   your libs directory, you can anyway build a fake kprintf and link without -ldebug.
  94. - you can both link it with or without ixemul, but libnix executables (-noixemul) has
  95.   better performances, also note that libnix is almost threadsafe while morphos ixemul
  96.   is not, so you may have problems with ixemul multithread programs.
  97.  
  98. The provided examples and SDLroids use the shared 68k library.
  99.  
  100. More info on my webpage (http://ggreco.interfree.it/sdl.html) or the SDL Amiga related
  101. mailinglist: 
  102. SDL-Amiga@yahoogroups.com
  103.  
  104.  
  105. Source:
  106.  
  107. The source of SDL is available in a separate archive on my web page or in the official
  108. source package at www.libsdl.org (get the CVS version if you have cvs installed).
  109.  
  110. You can find a lot of stuff that often compiles with a simple "make" on the
  111. OFFICIAL libSDL website:
  112.  
  113. http://www.libsdl.org
  114.  
  115. This site includes lots of games, utility, docs about SDL and SDL programming,
  116. with your contribution we will be able to port TONS of application to AmigaOS!
  117.  
  118. You can find some informations and download specific of the SDL amiga 
  119. implementation at the following URL:
  120.  
  121. http://ggreco.interfree.it/sdl.html
  122.  
  123. You can also subscribe to the SDL-Amiga mailing list sending a mail to:
  124.  
  125. sdl-amiga-subscribe@yahoogroups.com
  126.  
  127. For info, support, bugfix and other feel free to mail me:
  128.  
  129. Gabriele Greco (gabriele.greco@aruba.it/gabrielegreco@tin.it)
  130.